home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / msdos / apndfile.zip / APNDFILE.DOC next >
Text File  |  1993-07-26  |  5KB  |  137 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.              ****** Append File Version 1.0 *******
  7.  
  8.             A Utility To Combine ASCII Text Files            
  9.  
  10.         Copyright (c) 1993 Kevin Myers, All Rights Reserved
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Warranty:
  17.     Append File 1.0 is supplied to the user without warranty either written
  18. or implied.  The user agrees to assume all risks in running this program,
  19. regardless of users ability and/or inability to use this software.  Kevin
  20. Myers will not be liable for any claims by any and all third parties.  All
  21. risks associated with this software are the complete responsibility of
  22. the end user.
  23.  
  24. Preface:
  25.     Append File is a down and dirty utility to attach one ASCII file to
  26. another ASCII file.  Append File is designed to give maximum flexibility
  27. and speed. Append File uses three methods of operation to give you this
  28. flexibility.  The first is the command line option, second is via a data
  29. file (much like the "MAKE" file programmers know), third is through the
  30. familiar wild card.
  31.  
  32. To Install:
  33.     To install Append File, uncompress it in a directory in your path.
  34. This can be a newly created directory or an existing one, like C:\UTIL.
  35. I don't recommend using your DOS directory.
  36.  
  37. To Run Append File:
  38.     Append File is operated by typing APNDFILE at the DOS prompt and
  39. pressing <enter>. This will give you the information screen:
  40.  
  41. APENDFILE - Copyright Kevin Myers (c) 1993. Version B4.00
  42. Usage - APNDFILE -e [-p] [-t] [-m] [-l] [-n] [-w]
  43.  
  44. -eXXXXXXXX.XXX  Name of append file \'APPEND.TXT\'.
  45. -pnn            Page numbers. Lines per page.
  46. -t\"XXX...\"    Title of next file to be appended. May be used multiple times.
  47. -mXXXXXXX.XXX   File being attached.  May be used multiple times.
  48. -lXXXXXXXX.XXX  File list.
  49. -wXXXXXXX.XXX   Enables wild cards to be used.
  50. -n              Places wild card file name at the top of each section.
  51.  
  52.     Use switches in order of appearance, -t & -m may be used multiple times.
  53. The -t preceding an -m will attach that title to that file. -t preceding an -w
  54. will attach that title to the top of all the files.  
  55.  
  56.     -l, file list can be used in place of the command line switches.  Create
  57. a file with the same switches as the command line but one per line ending
  58. with a carriage return <enter>.
  59.  
  60.     The options -l, and -w can only be used by registered users.  This copy
  61. is ** REGISTERED **.
  62.  
  63.     As mentioned before, Append File offers three methods of processing
  64. files. The first is the command line option:
  65.  
  66.     APNDFILE -efile.txt -p60 -t"This the first file" -mread1st.doc
  67.     -t"This is the second file" -mprog.doc
  68.  
  69.     Also, a space may be present between the switch and the text:
  70.  
  71.     APNDFILE -e file.txt -p 60 -t "This the first file" -m read1st.doc
  72.     -t "This is the second file" -m prog.doc
  73.  
  74.  
  75.     This will allow you to enter as many files as your DOS environment will
  76. allow. Please note that only the command line routine works with the
  77. evaluation program.  A batch file may be used to extend the DOS limit.
  78.  
  79.     The second and third methods are only available in the registered
  80. version only. The second method uses a file to hold your options:
  81.  
  82.     APNDFILE -l afile.dat
  83.  
  84.     The file afile.dat contains:
  85.  
  86.     -e file.txt
  87.     -p 60
  88.     -t "This the first file"
  89.     -m read1st.doc
  90.     -t "This is the second file"
  91.     -m prog.doc
  92.  
  93.     For up to seventy lines. Each line must end with a carriage return /
  94. line feed <enter>. Strings of words with spaces in them must be enclosed
  95. in quotes "like this".  And, there may or may not be spaces between the
  96. switch and the processing information, i.e. -e file.nam and -efile.nam
  97. are the same.
  98.  
  99.     The third and last method is the wild card option.  Just use the -w
  100. switch with the options of your choice:
  101.  
  102.     APNDFILE -e wildfile.txt -n -w *.txt
  103.  
  104.     This will append together all files ending with .TXT and put there
  105. filenames at the beginning of each. The application of this option is
  106. obvious, the BBS.  The -n switch places the DOS filename at the top of each
  107. appended file. The -t option places a title at the top of the whole file
  108. only.
  109.  
  110. Registration:
  111.     Append File comes to you under the Shareware concept.  Use this
  112. program  for thirty days.  If you find it useful send me, Kevin Myers,
  113. $5.00, PROGRAM VERSION NUMBER, and your name and mailing address to receive
  114. instructions how to upgrade your program to registered status.
  115.  
  116.                         Kevin Myers
  117.                         11621 Samoline Ave.
  118.                         Downey, CA 90241
  119.  
  120.  
  121.                         Or:
  122.                         Contact me on the TDE BBS:
  123.                         VirtualNet 53@1310003
  124.                         WWIVNet    53@3084
  125.                         WWIVLINK   53@13065
  126.                         DATANet    53@3002
  127.                         RPG net    53@1310000
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.